home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglcopyteximage1dext.z / fglcopyteximage1dext
Encoding:
Text File  |  2001-04-17  |  14.1 KB  |  201 lines
  1.  
  2.  
  3.  
  4. ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT - copy pixels into a 1D texture image
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT( INTEGER*4 _t_a_r_g_e_t,
  14.                                       INTEGER*4 _l_e_v_e_l,
  15.                                       INTEGER*4 _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  16.                                       INTEGER*4 _x,
  17.                                       INTEGER*4 _y,
  18.                                       INTEGER*4 _w_i_d_t_h,
  19.                                       INTEGER*4 _b_o_r_d_e_r )
  20.  
  21.  
  22. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  23.      _t_a_r_g_e_t          The target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD
  24.  
  25.      _l_e_v_e_l           The level-of-detail number.  Level 0 is the base image
  26.                      level.  Level _n is the _nth mipmap reduction image.
  27.  
  28.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  The internal storage format of the texture image.  Must
  29.                      be one of the following symbolic constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA,
  30.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888____EEEEXXXXTTTT, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222____EEEEXXXXTTTT,
  31.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____EEEEXXXXTTTT,
  32.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____EEEEXXXXTTTT,
  33.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  34.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222____EEEEXXXXTTTT,
  35.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT,
  36.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666____EEEEXXXXTTTT,
  37.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY____EEEEXXXXTTTT, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444____EEEEXXXXTTTT, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888____EEEEXXXXTTTT,
  38.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222____EEEEXXXXTTTT, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB,
  39.                      GGGGLLLL____RRRRGGGGBBBB2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB4444____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB5555____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB8888____EEEEXXXXTTTT,
  40.                      GGGGLLLL____RRRRGGGGBBBB11110000____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11112222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11116666____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA,
  41.                      GGGGLLLL____RRRRGGGGBBBBAAAA2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA4444____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA8888____EEEEXXXXTTTT,
  42.                      GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA11112222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA11116666____EEEEXXXXTTTT.  (Note
  43.                      that the values 1, 2, 3, and 4, which are accepted by
  44.                      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, are not accepted by ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT.)
  45.  
  46.      _x               The x coordinate of the lower-left corner of the pixel
  47.                      rectangle to be transferred to the texture array.
  48.  
  49.      _y               The y coordinate of the lower-left corner of the pixel
  50.                      rectangle to be transferred to the texture array.
  51.  
  52.      _w_i_d_t_h           The width of the texture image.
  53.  
  54.      _b_o_r_d_e_r          The border width of the texture.  Must be 0 or 1.
  55.  
  56. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  57.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT defines a one-dimensional texture image with pixels
  58.      from the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR (rather than from main memory, as is the
  59.      case for ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD).
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      The screen-aligned pixel rectangle with lower-left corner at (_x, _y)
  75.      having width _w_i_d_t_h+2*_b_o_r_d_e_r and height 1 is used to define the texture
  76.      array at the mipmap level specified by _l_e_v_e_l.  The internal format of the
  77.      texture array is selected by _i_n_t_e_r_n_a_l_f_o_r_m_a_t.
  78.  
  79.      The pixels in the rectangle are processed exactly as if ffffggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had
  80.      been called, but the process stops just before final conversion.  At this
  81.      point all pixel component values are clamped to the range [0, 1] and then
  82.      converted to the texture's internal format for storage in the texel
  83.      array.
  84.  
  85.      Pixel ordering is such that lower x screen coordinates correspond to
  86.      lower i texture coordinates, and lower y screen coordinates correspond to
  87.      lower j texture coordinates.
  88.  
  89.      If any of the pixels within the specified rectangle of the current
  90.      GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the window associated with the current
  91.      rendering context, then the values obtained for those pixels are
  92.      undefined.
  93.  
  94. NNNNOOOOTTTTEEEESSSS
  95.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT is part of the EEEEXXXXTTTT____ccccooooppppyyyy____tttteeeexxxxttttuuuurrrreeee extension.  See
  96.      ffffggggllllIIIInnnnttttrrrroooo for more information about using extensions.
  97.  
  98. EEEERRRRRRRROOOORRRRSSSS
  99.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated when _t_a_r_g_e_t is not one of the allowable
  100.      values.
  101.  
  102.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than zero or greater than
  103.      log (_m_a_x), where _m_a_x is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  104.         2
  105.  
  106.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if the specified image is too large.
  107.  
  108.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h is less than zero, greater than
  109.                                                                     k
  110.      2+GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or when _w_i_d_t_h cannot be represented as 2 +2border
  111.      for some integer k.
  112.  
  113.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
  114.  
  115.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not one of the
  116.      allowable values.
  117.  
  118.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT is executed
  119.      between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  120.      ffffggggllllEEEEnnnndddd.
  121.  
  122. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  123.      ffffggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                                                         PPPPaaaaggggeeee 2222
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))       OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee       ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT((((3333GGGG))))
  139.  
  140.  
  141.  
  142. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  143.      ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD and ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT are not supported on
  144.      RealityEngine, RealityEngine2, and VTX systems.
  145.  
  146.      On InfiniteReality systems, there is a performance benefit when the width
  147.      of the image to be transferred to texture memory is a multiple of 8.
  148.  
  149.      Texture borders are not supported on InfiniteReality systems.
  150.      Applications should use borderless textures and GGGGLLLL____CCCCLLLLAAAAMMMMPPPP____TTTTOOOO____EEEEDDDDGGGGEEEE____SSSSGGGGIIIISSSS
  151.      wrap mode.
  152.  
  153.  
  154. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  155.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDDEEEEXXXXTTTT, ffffggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                                                         PPPPaaaaggggeeee 3333
  198.  
  199.  
  200.  
  201.